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INTEGRATED DEVELOPMENT ENVIRONMENT WITH CONTEXT SENSITIVE 
DATABASE CONNECTIVITY ASSISTANCE 

BACKGROUND OF THE INVENTION 

5 

1. Technical Field: 

The present invention relates to software 
development and, in particular, to Java database 
connectivity. Still more particularly, the present 
10 invention provides a method, apparatus, and program for 
providing Java database connectivity assistance in an 
integrated development environment . 

2. Description of Related Art: 

15 Java is an object-oriented programming language 

designed to generate applications that can run on all 
hardware platforms, small, medium and large, without 
modification. Java was modeled after C++, and Java 
programs can be called from within hypertext markup 

20 language (HTML) documents or launched stand alone. When 
a Java program called from a Web page runs on a user's 
machine, it is called a "Java applet." ' When a Java 
program is run on a Web server, it is called a "servlet." 
When a Java program runs as a stand-alone, non Web-based 

25 program on a user's machine, it is simply a "Java 
application . " 

An integrated development environment (IDE) is a set 
of programs run from a single user interface for software 
development. For example, programming languages often 
30 include a text editor, a compiler, and a debugger, which 
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are all activated and function from a common menu. 
However, when coding Java database connectivity in Java 
IDEs, such as VisualAge for Java from IBM Corporation, 
the user frequently incorporates database related 
statements. Database related statements may include, for 
example, structured query language (SQL) statements. 
These statements usually require knowledge of the data 
model involved and the tables being affected. 

Currently, integrated development environments do 
assist the coder in his/her efforts. However, the 
programmer typically would need to open more application 
windows in order to find out the exact definitions of the 
tables and columns in the databases" being used. That is, 
the programmer has to open the control centers for the 
database management systems, open the databases, open the 
tables, and then open the schema to see the column 
definition for each column being referenced in a 
statement . 

Therefore, it would be advantageous to provide an 
improved code assist feature that takes into account that 
a programmer might be interacting with a database. 
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SUMMARY OF THE INVENTION 

The present invention provides a database 
connectivity assistance tool in an integrated development 
5 environment. The user provides database information for 
each connection to be used in a project. The database 
information may include schema name, database name, 
username, password, port number, etc. When a user is 
coding a database related statement, such as a structured 

10 query language statement, the user may access the 

database connectivity assistance tool. If there is a 
plurality of databases being used, the database 
connectivity assistance tool may determine whether a 
table name is specified unambiguously. If the table 

15 exists in more than one of the pre-specif ied database 

connections, then the assistance tool prompts the user to 
specify to which database the statement is referring. 
Once the database and table are identified, the user may 
choose from a list of available column names to complete 

20 a database related statement. Metadata may also be 

provided to the user for the type of column. The user 
may also set values and conditions for columns in 
database related statements. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

The novel features believed characteristic of the 
invention are set forth in the appended claims. The 
5 invention itself, however, as well as a preferred mode of 
use, further objectives and advantages thereof, will best 
be understood by reference to the following detailed 
description of an illustrative embodiment when read in 
conjunction with the accompanying drawings, wherein: 
10 , Figure 1 depicts a pictorial representation of a 

network of data processing systems in which the present 
invention may be implemented; 

Figure 2 is a block diagram illustrating a data 
processing system in which the present invention may be 
15 implemented; 

Figure 3 depicts an example integrated development 
environment in accordance with a preferred embodiment of 
the present invention; 

Figures 4A-4M are example screens of display for an 
20 integrated development environment in accordance with a 
preferred embodiment of the present invention; 

Figure 5 is a flowchart illustrating the operation 
of an integrated development environment with a context 
sensitive database assistance tool in accordance with a 
25 preferred embodiment of the present invention; and 

Figure 6 is a flowchart illustrating the operation 
of a database information update mechanism in accordance 
with a preferred embodiment of the present invention. 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

With reference now to the figures, Figure 1 depicts a 
pictorial representation of a network of data processing 
5 systems in which the present invention may be implemented. 
Network data processing system 100 is a network of 
computers in which the present invention may be 
implemented. Network data processing system 100 contains 
a network 102, which is the medium used to provide 

10 communications links between various devices and computers 
connected together within network data processing system 
100. Network 102 may include connections, such as wire, 
wireless communication links, or fiber optic cables. 

In the depicted example, server 104 is connected to 

15 network 102 along with storage unit 106. In addition, 
clients 108, 110, and 112 are connected to network 102. 
These clients 108, 110, and 112 may be, for example, 
personal computers or network computers. In the depicted 
example, server 104 provides data, such as boot files, 

20 operating system images, and applications to clients 108- 
112. Clients 108, 110, and 112 are clients to server 104. 
Network data processing system 100 may include additional 
servers, clients, and other devices not shown. 

A programmer may code an application that accesses 

25 one or more databases. The programmer may code the 

application using a client, such as one of clients 108, 
110, and 112. The application may be coded using an 
integrated development environment (IDE) . The database 
may be stored, for example, in storage unit 106. In 

30 another example, the application may access a database in 
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storage unit 116 through server 104 or to a local database 
in storage 126. 

When coding Java database connectivity, in Java 
IDEs, such as VisualAge for Java from IBM Corporation, 
5 the user frequently incorporates database related 
statements, such as structured query language (SQL) 
statements. These statements usually require knowledge 
of the data model involved and the tables being affected. 
In accordance with a preferred embodiment of the 

10 present invention, an integrated development environment 
includes a database connectivity assistance tool. The 
user provides database information for each connection to 
be used in a project. The database information may 
include schema name, database name, username, password, 

15 port number, etc. This IDE is included in the client, 
such as client 108. The connections may include 
connections to databases in one or more of storage 106, 
storage 116, and storage 126. 

When a user is coding a database related statement, 

20 such as a structured query language (SQL) statement, the 
user may highlight the statement and access the database 
connectivity assistance tool for context sensitive 
assistance. If there is a plurality of databases being 
used, the database connectivity assistance tool 

25 determines whether the table is specified ambiguously. 

If the table exists in more than one of the pre-specif ied 
database connections, then the assistance tool prompts 
the user to specify to which database the statement is 
referring. If the database and table are unambiguous, 

30 the assistance tool may provide column selection, value 
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set, and/or search condition user interfaces. Other 
context sensitive assistance may also be provided to 
guide the user in completing a database related 
statement. 

5 In the depicted example, network data processing 

system 100 is the Internet with network 102 representing a 
worldwide collection of networks and gateways that use the 
Transmission Control Protocol/Internet Protocol (TCP/IP) 
suite of protocols to communicate with one another. At 

10- the heart of the Internet is a backbone of high-speed data 
communication lines between major nodes or host computers, 
consisting of thousands of commercial, government, 
educational and other computer systems that route data and 
messages. Of course, network data processing system 100 

15 also may be implemented as a number of different types of 
networks, such as for example, an intranet, a local area 
network (LAN) , or a wide area network (WAN) . Figure 1 is 
intended as an example, and not as' an architectural 
limitation for the present invention. 

20 With reference now to Figure 2, a block diagram 

illustrating a data processing system is depicted in which 
the present invention may be implemented. Data processing 
system 200 is an example of a client computer. Data 
processing system 200 employs a peripheral component 

25 interconnect (PCI) local bus architecture. Although the 
depicted example employs a PCI bus, other bus 
architectures such as Accelerated Graphics Port (AGP) and 
Industry Standard Architecture (ISA) may be used. 
Processor 202 and main memory 204 are connected to PCI 

30 local bus 206 through PCI bridge 208. PCI bridge 208 also 
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may include an integrated memory controller and cache 
memory for processor 202. Additional connections to PCI 
local bus 206 may be made through direct component 
interconnection or through add-in boards. 
5 In the depicted example, local area network (LAN) 

adapter 210, SCSI host bus adapter 212, and expansion bus 
interface 214 are connected to PCI local bus 206 by direct 
component connection. In contrast, audio adapter 216, 
graphics adapter 218, and- audio/video adapter 219 are 

10 connected to PCI local bus 206 by add-in boards inserted 
into expansion slots. Expansion bus interface 214. 
provides a connection for a keyboard and mouse adapter 
220, modem 222, and additional memory 224. Small computer 
system interface (SCSI) host bus adapter 212 provides a 

15 connection for hard disk drive 226, tape drive 228, and 
CD-ROM drive 230. Typical PCI local bus implementations 
will support three or four PCI expansion slots or add-in 
connectors . 

An operating system runs on processor 202 and is used 
20 to coordinate and provide control of various components 
within data processing system 200 in Figure 2. The 
operating system may be a commercially available operating 
system, such as Windows XP, which is available from 
Microsoft Corporation. An object oriented programming 
25 system such as Java may run in conjunction with the 

operating system and provide calls to the operating system 
from Java programs or applications executing on data 
processing system 200. "Java" is a trademark of Sun 
Microsystems, Inc. Instructions for the operating system, 
30 the object-oriented programming system, and applications 
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or programs are located on storage devices, such as hard 
disk drive 226, and may be loaded into main memory 204 for 
execution by processor 202. 

Those of ordinary skill in the art will appreciate 
5 that the hardware in Figure 2 may vary depending on the 
implementation. Other internal hardware or peripheral 
devices, such as flash read-only memory (ROM) , equivalent 
nonvolatile memory, or optical disk drives and the like, 
may be used in addition to or in place of the hardware 

10 depicted in Figure 2. Also, the processes of the present 
invention may be applied to a multiprocessor data 
processing system. 

As another example, data processing system 200 may 
be a stand-alone system configured to be bootable without 

15 relying on some type of network communication interfaces. 
As a further example, data processing system 200 may be a 
personal digital assistant (PDA) device, which is 
configured with ROM and/or flash ROM in order to provide 
non-volatile memory for storing operating system files 

20 and/or user-generated data. 

The depicted example in Figure 2 and above-described 
examples are not meant to imply architectural 
limitations. For example, data processing system 200 
also may be a notebook computer or hand held computer in 

25 addition to taking the form of a PDA. Data processing 
system 200 also may be a kiosk or a Web appliance. 

Figure 3 depicts an example integrated development 
environment in accordance with a preferred embodiment of 
the present invention. Integrated development 

30 environment (IDE) 300 includes a set of tools or programs 



10 

Docket No. AUS920030166US1 

run from a single interface. In the depicted example, 
the interface is graphical user interface (GUI) 310; 
however, the interface may be a non-graphical interface, 
such as a command line interface. 
5 In the example, shown in Figure 3, the set of tools 

includes text editor 302, compiler 304, build utility 
306, and debugger 308; however, more or fewer tools may 
be included within the scope of the present invention. 
For example f/ IDE 300 may include two or more compilers. 

10 Alternatively, IDE 300 may not include a build utility. 

In accordance with a preferred embodiment of the 
present invention, the IDE includes database assistance 
tool 350. The user provides database information and 
metadata 352 for each connection to be used in a project. 

15 The database information may include schema name, 

database name, username, password, , port number, etc. The 
database assistance tool may connect to each connection 
and retrieve the data model information and store this 
information locally at 352. 

20 A database data model may change. For example, a 

table or column may be added to a particular database. 
In accordance with a preferred embodiment of the present 
invention, the database data model is retrieved from the 
database itself, b s ased on the connectivity information 

25 provided by the user. Thus, the IDE may update the local 
database data model information from the actual 
connection periodically or whenever a connection is 
possible. For example, a developer may update database 
data model information for a plurality of connections in 

30 a project and use the IDE on an airplane or some other 
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location where a connection to the database is not 
possible or practical. 

When a user is coding a database related statement, 
such as a structured query language statement, the user 
5 may highlight a database related statement and access 

database connectivity assistance tool 350. If there is a 
plurality of databases being used, the database 
connectivity assistance tool determines whether the table 
is specified ambiguously. If the table exists in more 

10 ' than one of the pre-specif ied database connections, then 
the assistance tool prompts the user through GUI 310 to 
specify to which database the statement is referring. 
Once the database and table are identified, the database 
assistance tool may provide a list of available column 

15 names through the GUI. The user may then navigate the 
database assistance tool interfaces to populate the 
database related statement until the statement is 
complete . 

Next, with respect to Figures 4A-4K, example screens 
20 of display for an integrated development environment are 
shown in accordance with a preferred embodiment of the 
present invention. More particularly, Figure 4A 
illustrates IDE window 400, which includes menu bar 402. 
Menus to be selected from menu bar 402 may include 
25 "File," "Edit," "View," "Project," "Build," "Debug," 

"Settings," "Tools," "Window," and "Help." However, menu 
bar 402 may include fewer or more menus, as understood by 
a person of ordinary skill in the art. Alternatively, 
IDE window- 400 may include no menu bar depending upon the 
30 implementation . 
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The IDE window also includes project display area 
404 in which project code is entered. The IDE window may 
also include build display area 406 and output display 
area 408. The build display area may display, for 
5 example, a build script or build log. The output display 
area may display other output messages for the project. 

In the depicted example, project display area 404 
includes example code in which an entire SQL statement is 
entered. The SQL statement is as follows: 

10 sqll - "SELECT EMPNO, FIRSTNME FROM MYEMPTABLE" ; 

The developer must hard code the column names in the 
query, which means the developer must know the column 
names first. 

With reference to Figure 4B, the IDE window is shown 
15 without hard coding the entire SQL statement. The 
developer begins SQL statement 410 as follows: 

sqll = "SELECT from MYEMPTABLE" 

The developer may then activate the context sensitive 
database assistance tool, such as by right clicking the 
20 SQL statement, choosing the assist tool from a menu, 

depressing a function key or keyboard shortcut, or the 
like. 

Figure 4C illustrates the IDE window with a right- 
click menu 412, which may result from right clicking on 
25 the SQL statement. In this example, the right-click menu 
includes only one item, "SQL Assist. " However, the 
right-click menu may include more items for assisting the 
user with an SQL statement or other code. 
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Next, with reference to Figure 4D, database 
assistance interface window 420 is shown in accordance 
with a preferred embodiment of the present invention. 
Interface window 420 presents a column selection 
5 interface including column selection checkboxes 422 for 
the "select" statement shown in Figure 4C. Using 
interface window 420, the user may select columns to 
select from the table MYEMPTABLE specified in the 
highlighted statement. For example, in Figure 4D the 
10 columns "EMPNO" and "FIRSTNME" are selected. In the 

example shown in Figure 4D, the resulting statement would 
be as follows: 

sqll - "SELECT EMPNO, FIRSTNME FROM MYEMPTABLE" 

Turning to Figure 4E, the IDE window is shown with 
15 an example "insert" SQL statement • The developer begins 
SQL statement 430 as follows: 

sql2 - "INSERT INTO MYEMPTABLE" 

The developer may then activate the context sensitive 
database assistance tool. 

20 Figure 4F illustrates database assistance interface 

window 432, which presents a record insertion interface. 
Interface window 432 presents the existing columns and, 
using interface window 432, the user may enter values for 
a record to be inserted into the database. For example, 

25 . in Figure 4F a value for the column "EMPNO" is being 
entered. Data values for the record entered into the 
insertion interface are then added to the "insert" 
statement. Thus, the database assistance interface 
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allows the user to populate a statement using context 
sensitive assistance . 

The database assistance tool may also alert the user 
when errors are made or when an entered value does not 
5 comply with the metadata for the column. For example, . in 
Figure 4G, the user fails to enter a value for the column 
"EMPNO," which is not nullable, meaning the column must 
have a value assigned. The database assistance tool 
presents a context sensitive warning 434 to alert the 
10 user of the error. The database assistance tool may 
alert the user to other errors or violations, such as 
syntax errors, values with improper length or data type, 
and the like. 

Turning now to Figure 4H, the column "WORKDEPT" 436 
15 has a default value of "Sales." The database .assistance 
tool may automatically populate fields with their default 
values. Alternatively, the database assistance tool may 
include a control, such as button 438, for each column 
with a default value. The database assistance tool may 
20 then populate the field with the default value responsive 
to the user selecting button 438. 

Next, with reference to Figure 41, the IDE window is 
shown with an example "update 7 ' SQL statement. The 
developer begins SQL statement 440 as follows: 

25 sql3 = "UPDATE MYEMPTABLE WHERE" 

The developer may then activate the context sensitive 
database assistance tool. 

Figure 4J illustrates database assistance interface 
window 442, which presents a column set value interface. 
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Interface window 442 presents the existing columns and, 
using interface window 442, the user may select columns 
using selection checkboxes 444 and set values for the 
selected columns in the "Value" field. For example, in 
5 Figure 4H, the column "WORKDEPT" is selected and the user 
may enter a value, such as "sales," into the value field 
to set a value for WORKDEPT in the "update" statement. 

Next, Figure 4K illustrates database assistance 
interface window 446, which presents a search condition 

10 interface. Interface window 446 presents the existing 
columns and, using interface window 446, the user may 
select columns using selection checkboxes 448 and set 
search condition values for the selected columns in 'the 
"Value" field. For example, in Figure 41 the column 

15 "EMPNO" is selected and the user may enter a value, such 
as "0001," into the value field to set a search condition 
value for WORKDEPT in the "update" statement. 

The result of the examples shown in Figures 4J and 
4K would be the following statement: 

20 sgl3 = "UPDATE MYEMPTABLE SET WORKDEPT= * sales ' WHERE 

EMPNO= A 0001' " 

Thus, the developer may fully populate a database related 
statement using the context sensitive database assistance 
tool without having to know the database, table name, 
25 column name, etc. 

The column set value interface and the search 
condition interface also include meta data for the 
columns to assist the user. For example, the user may 
enter information into the value field based upon the 
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data type, length, precision, scale, mailable, and 
default fields shown in the interface window. 

With reference to Figure 4L, the IDE window is shown 
with/ an example "delete" SQL statement. The developer 
5 begins SQL statement 450 as follows: 

sgl4 = "DELETE FROM MY WHERE 7 ' 

The developer may then activate the context sensitive 
database assistance tool. In this example, the table 
"MY" may be ambiguous. 

10 Figure 4M illustrates database assistance interface 

window 452, which presents a table selection interface. 
Interface window 452 presents tables that satis-fy the 
database term "MY" In the database related statement. 
Using interface window 452, the user may select a table 

15 using selection checkboxes 454. 

In the example shown in Figure 4K, the tables 
matching the term "MY" exist in multiple databases and 
may have different schemas. Thus, interface window 452 
allows the user to disambiguate the table and the 

20 database with a single selection. In the example shown 
in Figure 4M, table "schemal .MYEMPTABLE" exists in 
database "datal." The table "schema2 . MYEMPTABLE" exists 
in database "data2". And both "schema2 . MYCLIENTABLE" and 
"schema 3 . MYAUXTABLE" exist in the database "data3." 

25 In this example, the table name "MYEMPTABLE" exists 

in two different databases and in two different schemas. 
Therefore, the database assistance interface allows 
multiple levels of disambiguation. Alternatively, the 
database assistance tool may present separate database 
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selection and table selection interfaces within the scope 
of the present invention. Furthermore, the tables that 
fit the table specified in the statement may not exist in 
separate databases, in which case the interface window 
5 may only present the table names for selection. 

With reference to Figure 5, a flowchart is shown 
illustrating the operation of an integrated development 
environment with a context sensitive database assistance 
tool in accordance with a preferred embodiment of the 

10 present invention. The process begins and a 

determination is made as to whether an exit condition 
exists (step 502) . An exit condition may exist, for 
example, when the user closes the IDE. If an exit 
condition exists, the process ends. 

15 ' If an exit condition does not exist in step 502, a 

determination is made as to whether a statement is 
selected (step 504) . If a statement is not selected, the 
process returns to step 502 to determine whether an exit 
condition exists. If a statement is selected in step 

20 504, a determination is made as to whether the selected 
statement is complete (step 506) . If the statement is 
complete, the process returns to step 502 to determine 
whether an exit condition exists. 

If the statement is not complete in step 506, a 

25 determination is made as to whether a database is 

ambiguous (step 508) . If a database in the statement is 
ambiguous, the process generates a database selection 
interface (step 510) , populates the statement based on 
user input (step 512) and returns to step 506 to 

30 determine whether the statement is complete. 



18 



Docket No. AUS920030166US1 

If the database is not ambiguous in step 508, a 
determination is made as to whether a table is ambiguous 
(step 514) . If a table is ambiguous, the process 
generates a table selection interface (step 516) and 
5 continues to step 512 to populate the statement based on 
user input. Thereafter, the process returns to step 506 
to determine whether the statement is complete. 

If a table is not ambiguous in step 514, a 
determination is made as to whether column information is 

10 ambiguous in the statement (step 518) . If column 

information is ambiguous, the process generates a column 
selection, insertion, value set, and/or search condition . 
interface (step 520) and continues to step 512 to 
populate the statement based on user input. Thereafter, 

15 the process returns to step 506 to determine whether the 
statement is complete. 

If column information is not ambiguous in step 518, 
the process generates other interfaces with context 
sensitive assistance to complete the statement (step 522) 

20 and continues to step 512 to populate the statement based 
on user input. Thereafter, the process returns to step 
506 to determine whether the statement is complete. 

With reference now to Figure 6, a flowchart 
illustrating the operation of a database information 

25 update mechanism in accordance with a preferred 

embodiment of the present invention. The process begins 
. and considers the first database connection (step 602) . 
Then, the process connects to the database (step 604) and 
a determination is made as to whether the data model for 

30 the database has changed (step 606) . 
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If the database data model has changed, the process 
updates the locally stored database data model (step 608) 
and a determination is made as to whether the database 
connection is the last connection in the 'project (step 
5 610) . If the database connection is the last connection, 
the process ends. 

If, however, the database connection is not the last 
connection in the project in step 610, the process , 
considers the next database connection (step 612) and 
10 returns to step 604 to connect to the next database. 

Returning to step 606, if the data model has not changed, 
the process continues to step 610 to determine whether 
the database connection is the last connection in the 
project. 

15 Thus, the present invention solves the disadvantages 

of the prior art by providing a context sensitive 
database connectivity assistance tool in an integrated 
development environment. The user provides database 
information for each connection to be used in a project. 

20 The database information may include schema name, 

database name, username, password, port number, etc. 
When a user is coding a database related statement, such 
as a structured query language statement, the user may 
highlight a table name and access the database 

25 connectivity assistance tool. If there is a plurality of 
databases being used, the database connectivity 
assistance tool determines whether the table is specified 
ambiguously. If the table exists in more than one of the 
pre-specif ied database connections, then the assistance 

30 tool prompts the user to specify to which database or 
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table the statement is referring. Once the database and 
table are identified, the user may choose from a list of 
available column names to complete the database related 
statement. Metadata may also be provided to the user for 
5 the type of column. The user may also set values and 
conditions for columns in database related statements. 

It is important to note that while the present 
invention has been described in the context of a fully 
functioning data processing system, those of ordinary 

10 skill in the art will appreciate that the processes of 

the present invention are capable of being distributed in 
the form of a computer readable medium of instructions 
and a variety of forms and that the present invention 
applies equally regardless of the particular type of 

15 signal bearing media actually used to carry out the 
distribution. Examples of computer readable media 
include recordable-type media, such as a floppy disk, a 
hard disk drive, a RAM, CD-ROMs, DVD-ROMs, and 
transmission-type media, such as digital and analog 

20 communications links, wired or wireless communications 
links using transmission forms, such as, for example, 
radio frequency and light wave transmissions. The 
computer readable media may take the form of coded 
formats that are decoded for actual use in a particular 

25 data processing system. 

The description of the present invention has been 
presented for purposes of illustration and description, 
and is not intended to be exhaustive or limited to the 
invention in the form disclosed. Many modifications and 

30 variations will be apparent to those of ordinary skill in 
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the art. The embodiment was chosen and described in 
order to best explain the principles of the invention, 
the practical application, and to enable others of 
ordinary skill in the art to understand the invention for 
5 various embodiments with various modifications as are 
suited to the particular use contemplated. 



